Copyright: Copyright 1995-1999 Ipswitch, Inc.


Table of Contents

Getting Started

Overview

Logging On

Notes about "Delete Host Mail"

Main Window

Main Window Menu Bar

Reading Mail

Reading Mail in the Message Window

Message Window Menu Bar

Working with Mailboxes

Delivery Rules

URL Execution Support

Set Message Flags dialog box

Sending Mail

Sending Mail

Using the Address Book

Specifying Recipients

Setting Options

Viewing Options

Sending Options

System Options

User Information Options

Message Options


Overview

IMail Client provides a user interface for reading and sending mail. This is a special application that is automatically installed on the IMail Server system when IMail Server is installed. Imail client provides

•	A POP3 client for reading mail from a server

•	An SMTP client for sending mail

•	An SMTP server for receiving mail sent directly to the Imail Client system

Note that IMail Client is provided only for the convenience of IMail Server administrators who are running IMail Server on an NT workstation. IMail Client provides the Imail Server system administrator with a simple mail client on the IMail Server system for testing or troubleshooting IMail Server. It is especially useful for using “dummy” accounts for testing purposes and for reading the “root” mailbox or the mailboxes of other seldom-used accounts.

Warning: The IMail Client application should NOT be used on the IMail Server system to view actual end-user mailboxes, as this may cause problems with remote access to the same mailboxes, depending on the remote clients being used.


Logging On
“Logon” dialog box

“Mailbox” section

The top section of this dialog box is for configuring the mailbox where the current user will receive mail. The information entered here becomes the current user’s profile, a collection of user settings. Thereafter, you need only select the desired user profile from the User-ID drop-down list to log on as the current user.

1	User-ID. Enter the user ID you want to log on with.

2	Full Name. Enter the full name for the current user. This will be used in the From field when the current user creates a mail message.

3	Return Address. Enter the complete e-mail address to which other people can send e-mail to the current user.

4	Mailbox. Select the mailbox IMail Client will use for the current user.

“POP3” section

You can set up IMail Client to read the current user’s mail directly from the IMail Server, or you can configure IMail Client to use the POP3 protocol for the current user’s mail.

To read mail directly:

•	Make sure POP3 Mail Check is turned off. IMail Client ignores any settings in the POP3 section except for Check (minutes).

To read mail using POP3:

1	Make sure POP3 Mail Check is turned on. Note that the POP connection will be dropped when the current user changes mailboxes; therefore, if you change mailboxes and want to reestablish the POP connection, select Logon from the File menu.

2	Host. Enter the name of the IMail server.

3	User-ID. Enter the user ID you want to log on with.

4	Password. Enter the password for the user ID.

5	Do one of the following:

•	To move the user’s mail from the IMail Server directory to the IMail Client directory, turn on Delete Host Mail. IMail Client transfers the mail to the appropriate MAIN mailbox and then disconnects from the server.

•	To leave undeleted mail in the IMail Server directories, turn off Delete Host Mail. See also Notes about "Delete Host Mail".

6	In the Check (minutes) at the bottom of the dialog box, enter how often you want IMail Client to re-establish a connection to the host system to check for new mail when the current user is logged on (when Delete Host Mail is turned on.


Main Window

The main window consists of a menu bar, a toolbar, a mailbox list, and a message list (for the selected mailbox). Each mailbox list includes:

•	The name of the mailbox

•	The number of messages in the mailbox the last time the current user opened it

•	An indicator of new mail in a mailbox (if any)

•	The size of the mailbox in characters

•	The date and time that mail was last placed into that mailbox or the mailbox was last read.

Initially, this window has only the mailbox Main displayed. The Main mailbox cannot be renamed or deleted.

Below the mailbox list is the message list. Each item in the list includes up to 15 characters of the sender’s name, the date the message was sent, and the subject line of the message.


Main Window Menu Bar

File menu

Open. Saves all changes, closes the current mailbox, and displays the standard file “Open” dialog box, in which you can open any file as a mailbox.

Close. Saves all changes and closes the current mailbox.

POP Logon. Saves all changes, closes the current mailbox, and displays the initial logon dialog box.

Address Book. Displays the Address Book dialog box.

Mailboxes. Displays a list of existing mailboxes for the logged-on user.

Outbox. Displays a dialog box listing all messages in the outbound mail queue. Messages that are in the process of being delivered appear here.

Settings. Displays a dialog box with buttons across the top that let you modify system options, user info options, viewing options, or sending options for the current user. You can also use the Rules button to create a delivery rule for the current user.

Flags. Displays a dialog box allowing you to modify the flags on a message in the for the current user’s account. The message can be marked as Deleted, Read, Answered/Forwarded, or the opposite states.

Exit. Writes all changes, closes the current mailbox, and exits the program.

Message menu

Send. Creates a new message.

Reply. Displays the "Create new message" window with the recipient set to the sender of the message you are currently reading.

Forward. Forwards a message to another user. To forward a message and add something new to it, select Forward while viewing the contents of the message.

View. Displays the contents of the selected message.

Delete. Marks the currently selected mail message for deletion. If the current message is already deleted, clicking this button undeletes it. Note that you cannot read a deleted message when using POP3.

Transfer. Transfers a message into another mailbox or file. You can either select a mailbox or enter a new name to create a new mailbox. You do not have to specify the .MBX extension.

UnDelAll. Undeletes all the messages flagged for deletion.

Locate menu

Filter. Displays a dialog box that allows you to limit the messages that are displayed in the current user's Main window based on the content of any header. It is also possible to specify which messages NOT to display by turning on Reverse Filter.

Note: Turn on Enable Filter in order for the filter to actually be used. The filter stays on until you return to the dialog box as the current user and disable it, or until you log off as the current user or exit IMail Client. This allows you to set a filter for a particular user and to then apply it to each of the user’s mailboxes in turn.

Search. Allows you to search the current user’s current mailbox for a specific word or phrase. The search starts with the message following the selected message; to start searching from the first message, select the last message in the list before you select Search. If a filter is set, the search can be limited to only the messages that match the filter.

Note: Sometimes the search phrase is found in the message header. In this case, the highlight (or maybe not even the search phrase) is not visible unless Visible Headers: Show All is turned on the "Message Viewing Options" dialog box.

Search Again. Searches forward for the next occurrence of the search string.

Sort. Displays a dialog allowing you to specify the sort sequence and information layout for the current user.

Contents. Displays this help file.

Main Window. Displays help for the main window.

About. Displays the version number and copyright information.


Main Window: Toolbar

At the top of the main window is a toolbar that provides shortcuts to menu commands.

Send. Same as choosing Send from the Message menu.

Reply. Same as choosing Reply from the Message menu.

Forward. Same as choosing Forward from the Message menu.

View. Same as choosing View from the Message menu, or double-clicking a message in the list.

Delete. Same as choosing Delete from the Message menu.

Transfer. Same as choosing Transfer from the Message menu.

Search. Same as choosing Search from the Locate menu.

Filter. Same as choosing Filter from the Locate menu.

Sort. Same as choosing Sort from the Locate menu.

Check. Checks for new mail.

Exit. Saves all changes, closes the current mailbox, and exits the program.


Message Window

The message window is where you read a mail message for the current user. The message window is comprised of a menu bar, a toolbar, header information, and the message body area.

Press the Expand button to view the detailed message header.


Message Window Menu Bar

File menu

Settings. Displays a dialog box with options you can set for the current user; the options displayed depend on which button is selected at the top of the dialog box.

URL Definitions. This program supports the execution of URL entries. Supported URLs include HTTP, FTP, GOPHER, MAILTO and NEWS. Select or enter URL from the list and enter the desired path and executable. See also URL Execution Support.

Subjects. Returns you to the main window.

Exit. Saves all changes, closes the current mailbox, and exits the program.

Message menu

Next. Takes you to the next message that is not deleted, or to the main window if there are no more messages after this message.

Previous. Takes you to next earlier message that is not deleted, or to the main window if there are no messages before this message.

Send. Displays a blank, new message.

Reply. Displays a new message with the recipient set to the sender of the current message. The subject is automatically set to "Re: old_subject". The contents of the current message are copied to the body of the new message.

Forward. Displays a new message with the subject set to the current subject and the body of the message as editable text.

Delete. Marks the currently selected mail message for deletion. If the current message is already deleted, clicking this button undeletes it.

Transfer. Allows you to transfer a message into another mailbox or file. You can either select a mailbox or enter a new name to create a new mailbox. You do not have to specify the .MBX extension.

Print. Prints the current message. Only the displayed headers are printed. If you want all headers printed, turn on Visible headers: Show All in the "Viewing Options" dialog box prior to selecting Print.

Save Name. Save the sender’s address in the address book.

Copy to Clipboard. Copies any selected text to the clipboard; if no text is selected, copies the entire message to the clipboard.

View Header. Displays a window showing all the headers of the current message.

Detach Attached Files. If the current message contains an attachment, displays a prompt for filename.

Exec highlighted URL. Allows you to highlight a URL and execute it. Normally, a double click on a URL executes the URL. This menu command is useful when you only want to execute a portion of the URL.

Help menu

Contents. Displays this help file.

Message Window. Displays the Help topic on the Message Window.

About. Displays a dialog box showing the version number and copyright information.


Message Window Toolbar
Message Window: Toolbar

Subjects. Same as pressing ESC (returns to the main window where the message list is displayed).

<< Same as selecting Previous from the Message menu.

>> Same as selecting Next from the Message menu.

Send. Same as selecting Send from the Message menu.

Reply. Same as selecting Reply from the Message menu.

Forward. Same as selecting Forward from the Message menu.

Delete. Same as selecting Delete from the Message menu.

Transfer. Same as selecting Transfer from the Message menu.

Print. Same as selecting Print from the Message menu.

Save Name. Saves the address of the sender in the address book.

Expand. Displays a window where all the headers of the current message are displayed. (This button does not appear if the headers are already shown in full.)


System Options
“System Options” dialog box (File -> Settings -> “Systems” button)

Note: The System Options affect how the Imail Client application performs – NO MATTER WHO IS THE CURRENT USER; In other words, if these settings are changed while UserX is logged on, the UserX settings will still be set if UserX logs off and User Y logs on.

Miscellaneous

Timezone. The timezone is added to the end of the date of any messages sent. Any text value or number is valid here. Set this to something like EST, CST, MST, or -500, -800, etc.

Mail Check delay. The number of minutes between automatic checks for new mail when the current user is logged on (using POP3 and with Delete Host Mail turned on). This can be set to just about any value, but we recommend that it be greater than 3.

Sort Address Book. Turn this on to sort addresses alphabetically in the address book of anyone who logs on using this application. Otherwise, addresses are sequenced as follows: local addresses, shared addresses, aliases, and finally local user IDs. (Note that the address book probably will not have “shared addresses” or “aliases” since the use of these in Imail Client is not encouraged.

Verbose. Turn this on to increase the number of messages that are written to the SYSLOG file. Verbose should be turned on if you would ever like to look at the SYSLOG file to verify delivery of the current user’s mail messages.

Debug messages. Turn this on to increase the number of messages that are written to the log and to the status lines. This also changes the way some of the windows react and causes a debug window to appear when anyone is logged on. Leave Debug Messages off unless you have a specific problem that you are trying to catch or rectify.

SMTP Mailer

Send Direct. If this is turned on, all mail is sent directly to the destination host, if possible. If not possible, it is sent to the Smart Gateway. If this is turned off, all mail (except mail to the local system) is sent to the Smart Gateway.

Official Host Name. Enter the name of the Imail Client system. This will be ignored if it resolves to a non-local IP address. This is used in the From and Sender fields a message is created.

Smart Gateway. Enter the name of the IMail Server system. (For System Administrators using IMail Client to test IMail Server from the same system, this is the same name as the Official Host Name.)

Default Destination. Enter either localhost or leave blank. This name is appended to the end of the To mail address if the destination user ID is not local and no host name is specified in the destination mail address.

Domain Name Server. This must be the name or IP address of your DNS server. This is only used if the address of the DNS server cannot be retrieved from the network stack.

SMTP Server

Queue timer. Determines how often in minutes the SMTP server will retry sending messages that are not deliverable because a remote system is inaccessible.

Auto Start. Automatically starts the SMTP server when IMail Client starts.

Auto Stop on Exit. Automatically stops the SMTP server when IMail Client is exited.

Gateway mail for remote hosts and clients. Turn this on to have the SMTP server accept mail addressed to any host and redeliver that mail to the proper host. This allows the SMTP server to become a mail gateway.

Allow remote access to local lists. Turn this on to have the SMTP server accept mail addressed to local distribution lists (group aliases).


User Information Options
“User Information” dialog box (File -> Settings -> “User Info” button)

Use these settings to change the information that you entered when you logged on to IMail Client as the current user.

Local

Full Name. This is the full name as it will appear in the From header of the current user's outgoing messages.

Return mail address. This is the return mail address, as it will appear in the Reply-To field of outgoing messages.

Mailbox. Enter the full path of the mailbox you want IMail Client to use for the current user.

Inbound POP Password. This value is ignored.

POP3

Host. This is the name or IP address of the current user’s POP3 mail server. Leave this blank if the current user is not using POP3.

User-ID. This is the user ID on the mail server. Leave this blank if the current user is not using POP3.

Password. The password on the mail server.

Save POP Password. Turn this on to save the current user's password. Note that the password is saved in plain text in the IMAIL.INI file. Turn this on only when you are the sole person who can access the system.


Viewing Options
“Viewing Options” dialog box (File -> Settings -> “Viewing” button)

Print button. This brings up the “Print Setup” dialog box.

Headers Layout button. Click this button to change the sort order and header layout.

Miscellaneous

Auto delete on transfer. Turn this on to automatically tag messages for deletion when they are transferred to a different mailbox.

Audio on New Mail. Turn this on to play the system exclamation sound when new mail arrives in the current mailbox. NOTE: The system sound can be changed using the Windows Control Panel, if a sound card is installed. If Play NEWMAIL.WAV is turned on, the file NEWMAIL.WAV is played whenever new mail arrives.

Display Deleted Messages. Turn this on to have the current user’s mailbox listing include messages that have been deleted during the current session. This allows you to undelete or review those messages up until you exit the current mailbox.

Mailbox on bottom. This moves the mailbox list below the message list.

Enable Word Wrap. Turn this on to wrap text to fit in the current window.

POP Client

Prompt Limit. Turn this on to have IMail display a prompt before retrieving a POP3 message above a certain size for the current user; enter the size (in bytes) above which the prompt is displayed. (This was originally intended to prevent the downloading extremely large messages on a slow link.)

Message Font

This is where you select the font for reading and creating messages for the current user.

Visible Headers

Select the portions of the message headers that you want to be visible when reading a message for the current user. This also affects what is printed.

MIME Attachments

These options determine how IMail Client handles MIME files attached to incoming messages.

View MIME Raw. Normally, MIME content headers are automatically formatted and decoded. Turn this on to view the headers without formatting and decoding. This is useful for problem troubleshooting.

Auto save attachments. Turn this on to automatically save attachments to the ATTACHED directory under the current user‘s directory. Otherwise you will be prompted for a file name when the current user receives a message with an attachment.

Prompt for execution. Turn this on to have IMail display a prompt before executing an attachment that arrives for the current user.

Auto exec attachments. Turn this on to automatically execute a MIME attachment when the current user receives a message. WE RECOMMEND THIS BE TURNED OFF SINCE THIS COULD EXECUTE A VIRUS!

Auto save directory. This is the directory where attachments are saved by default.


Sending Options
“Sending Options” dialog box (File -> Settings -> “Sending” button)

Allow TAB in message body. Turn this on for normal use of the TAB key during the creation of a mail message. Turn this off to have the TAB key move the cursor to the Send button.

Auto wrap at. Turn this on to have text wrap at a particular number of characters both in message creation and message delivery for the current user. If the wrap is set to less than that of the window, IMail shrinks the window to the specified size. If the width of the wrap is greater than the size of the window, the message display will not match the message that is mailed.

Show delivery status. Turn this on if you want to be informed if a message was delivered successfully or not when you are logged on as the current user.

Prompt for Send Options. Turn this on to get prompted for special options when the Send button is clicked.

SMTP Send Direct. Turn this on to deliver mail directly to the recipient's workstation or host. If this is turned off and the message is not destined for the local system, the message is sent to a hub or gateway system for delivery.

Send Immediate. Select this to send the message as soon as you click the Send button when logged on as the current user.

Queue for later delivery. Select this to send the current user's messages “manually.” If this is selected, you must select File -> Outbox and send the message manually; this is useful for off-line creation of mail messages.

Auto BCC. If this is turned on, the value in the edit box to the right is entered automatically into the BCC field of every message sent by the current user. This allows you to possibly store a copy of every mail message sent by the current user. As an example, you could enter "userid-SENT" in this field, and a copy of every message sent would be stored in the "SENT" mailbox for the current user.

Attachments

Use MIME Standard. Select this to have attached files encoded using base64 and sent as MIME standard messages. If this is selected, the recipient must be using a MIME-compliant mail system to decode the message.

Use UUENCODE. Select this to have attached files encoded using UUENCODE and sent in the body of a standard message. If this is selected, the recipient must be using a UUDECODE program.

Encode attached text files. Turn this on to have the attached files encoded with base64 when a message is sent by the current user. This option can be used to improve the privacy of a transmitted message because it is much more difficult for someone capturing traffic on a network to see the message contents. If this is turned on, the recipient must be using a MIME-compliant mail system to decode the message.

Signature File

Use these settings to set up a signature file that is attached to all messages sent by the current user.

Include Signature File. Turn this on to cause the content of the specified file to be included at the end of every message sent by the current user. A signature file should have a blank first line and the second line should start with at least four hyphens.

Signature File. This needs to be the full pathname to the file that contains the signature for the current user. Click the Edit button to edit this file.

Shared Address Book.This option was provided in an earlier release to store the addresses that the current user has designated as Shared. We do not recommend using the Shared Address Book functionality since it can be exploited only in circumstances other than the one described in the Overview.


Inbound Processing Rules (Delivery Rules)

You can create a delivery rule for the current user.

1	If you are not already in the “Inbound Processing Rules” dialog box, select Settings from the File menu, and then click the Rules button.

2	Click the Add button. In the dialog box, leave the text area blank and click OK. An item, temporarily named “Rule,” appears in the Sequencing list.

3	In the “Rule Definition” area, select contain to have the delivery rule look for messages that contain the search string; select do not contain to look for messages that do not contain the search string.

4	Turn on Match Case to search for text that matches the case of the search string; to ignore case, turn off Match Case.

5	Enter the search text by doing one or more of the following:

•	Enter the literal text that you want to search for. For example, if you want to find the word “Free,” type: free. Note that the search text can be any literal text, except for a few characters that have special meaning.

•	Type search expressions and quantifiers as shown in Rule Syntax.

•	Click the small arrow to the right of the large search text box to use a popup menu to insert a generic form of a search expression and then edit the inserted expression.

•	Paste a portion of a mail message that meets the intended search criteria. For instance, you could copy and paste text such as XMSMailPriority(High) from the header of a message; this would search for High priority messages.

6	Next to ”in the section,” select the part of the e-mail to search.

7	Next to “to the folder/mailbox,” enter the name of the mailbox to which messages that meet the rule criteria will be sent. Indicate a sub-area by following the mailbox name with a hyphen and the name of the sub-area. Enter NUL to discard the message.

8	Click Apply to save the rule.

9	To re-sequence the processing order of the rules in the list, select a rule and click U (up) or D (down).

See also:

Overview of Mail Delivery Rules

How Delivery Rules are stored and processed

Delivery Rule Syntax

Characters with Special Meaning


Create Mail Message
“Create Mail Message” Window (in main window, click Send)

To. Enter the e-mail address to which you want to send this message. See also address books, and Specifying Recipients.

CC. “Carbon copy.” Enter the e-mail address to which you want to send a copy of this message.

BCC. Blind carbon copy. Use this box to keep a copy of the outgoing message in the current user's Main mailbox: simply enter the current user’s own mail address here.

The To, CC and BCC buttons are used to display the address book. You can also enter a partial name in the field(s) and press ENTER. If what you type matches just a single address, IMail fills in the rest for you. However, if IMail cannot find the address, or what you type matches multiple addresses, IMail takes you to the current user's address book.

Multiple recipients must be separated commas. If a recipient name has a comma in it, enclose the name with quotes.

Subject. Enter the subject of the message.

Message body. Enter the message text.

Attach. Click this button to attach any type of file to a mail message (provided the intended recipient is also using IMail or a MIME-compliant mail system).


Message Options
“Message Options” dialog box (in “Create-Mail-Message” Window, select Options -> Message Options)

Registered. Turn this on to get confirmation that a message was delivered or not. (This option uses the DOD method to add a “registered” header to the message; when Imail Server processes a message having this header, it sends the confirmation.)

Allow TAB in message text. Turn this on to allow the use of the TAB key during the creation of a mail message. If this is not turned on, the TAB key moves the cursor from the body text to the Send button.

Auto Wrap at. Turn this on to wrap text at a particular number of characters when you are logged on as the current user.

Auto BCC. If this is turned on, the value in the edit box to the right is entered automatically into the BCC field of every message that the current user sends. This allows you to possibly store a copy of every mail message the current user sends. As an example, you could enter "userid-SENT" in this field, and a copy of every message that you send would be stored in the "SENT" mailbox for the user "userid".

Show Delivery Status. Turn this on if you want to be informed if a message was delivered successfully or not.

Prompt for Send Options. Turn this on to get a prompt for special options when the Send button is clicked after the current user creates a new message.

“Set Send Options” button -> “Send Message” dialog box

Include signature. Turn this on to cause the content of the specified file to be included at the end of every message that current user sends. A signature file should have a blank first line and the second line should start with at least four hyphens.

Registered. Turn this on to get confirmation that a message was delivered or not. (This option uses the DOD method to add a “registered” header to the message; when Imail Server processes a message having this header, it sends the confirmation.)

Show Delivery Status. Turn this on if you want to be informed if a message was delivered successfully or not.

SMTP send direct. Turn this on to deliver mail directly to the recipient's workstation or host. If this is turned off and the message is not destined for the local system, the message is sent to a hub or gateway system for delivery.

Send Now. Sends the message right away.

Queue for later delivery. This controls when a message is sent after clicking the Send button. If turn this on, you must select File -> Outbox and send the message manually when current user is logged on. This option is useful for off-line creation of mail messages.

“Attachments” section of the dialog box

Use MIME Standard. Turn this on to have attached files encoded using base64 and sent as MIME standard messages. If this is turned on, the recipient MUST be using a MIME-compliant mail system.

Use UUENCODE. Turn this on to have attached files encoded using UUENCODE and sent in the body of a standard message. If this is turned on, the recipient should NOT be using a MIME-compliant mail system.

Encode text files. Turn this on to have the attached files encoded. If this is turned on, the recipient MUST be using a MIME-compliant mail system.

“Signature File” section of the dialog box

Include Signature File. Turn this on to cause the content of the specified file to be included at the end of every message that the current user sends. A signature file should have a blank first line and the second line should start with at least four hyphens.

Signature File. This needs to be the full pathname to the file that contains the signature. Press the Edit button to edit this file.


Working with Mailboxes

In the main window, select Mailboxes from the File menu to see a dialog box listing all the current user's existing mailboxes. From this dialog box, you can create new mailboxes for the current user, delete mailboxes, rename mailboxes, or select a new mailbox to view.

•	To add a mailbox, click the Add button.

•	To rename a mailbox, select the mailbox and click the Rename button.

•	To delete a mailbox, select the mailbox and click the Delete button.

•	To view the contents of a mailbox, select the mailbox and click the Select button.

You can also create a mailbox “on the fly” (as needed):

1	While in the message window, click the Transfer button to view the “Save As” dialog box. Each of the current user's existing mailboxes is shown as a file with a file extension of .MBX. For example, if the current user has a mailbox named “personal,” the mailbox is listed as a file named PERSONAL.MBX.

2	In the File Name box, enter a new mailbox name followed by the .MBX file extension.

3	Click Save.


Address Book
“Address Book” dialog box

IMail Client can store e-mail addresses in an Address Book. When you read a mail message as the current user, you can click the Save Name button to add the sender of the current message to the current user's address book. Otherwise, you add a name to the current user's Address Book “manually” as follows:

1	In the main window, select Address Book from the File menu.

2	Click New.

3	Click New Name and then click OK.

We don’t recommend this, but you can also select New List to create a list. However a list created this way will not appear in your mailbox, so you’ll need to memorize the list name in order to use it. (This Imail Client list is similar to a group alias you could create in Imail Administrator, except that no entry is made in the registry for the Imail Client list. Also, note that the settings on the SMTP Security tab in Imail Administrator that refer to “local groups” apply to these rather private lists created in Imail Client.)

1	Enter the Name and Address. Do not enter quotes or angle brackets when entering this information.

2	Select Personal to add the address to the current user’s address book.

•	We do not recommend selecting Shared since the address created using the Shared option can be exploited only in circumstances other than the one described in the Overview.

•	Note: Don’t select Alias because although an alias will be created, it will not be recognized by Imail Administrator, since Imail Administrator aliases are stored in the registry and aliases created in Imail Client are not.

1	Click OK.

2	In order for the name to actually be saved, you must exit the dialog box by clicking OK.

To modify or delete an address in the current user’s Address Book, select the name and click Modify or Delete. Note that you can NOT modify or delete the addresses of users that were created in IMail Administrator.

If you display the current user's Address Book by clicking the To, CC, or BCC buttons in a mail message, you can select recipients and click the Add to Recipients button. When you click OK, the selected recipients are inserted in the appropriate box of the new mail message.


Specifying Recipients

Recipients are specified in one of the following formats (any of these can and should use angle brackets <> to force the focus to the correct portion of the name):

userid	This is the shortest form that can be used for an address. It can only be used if the recipient is on the local system.
userid-mailbox userid-mailbox@remotehost	Use this form of address when sending mail to another IMail system as well as some of the other intelligent mail systems, where the mail is automatically delivered to the specified mailbox of the user ID. An equal sign (=) may be used in place of the hyphen (-).
userid@host	This form is used to specify a user located on a different mail host.
@host1:userid@host2	This is an address form that is used to cause mail for userid to be delivered to host1 for third party delivery to host2.
userid%host2@host1	This is an address form that is used to cause mail for userid to be delivered to host1 for third party delivery to host2. There can actually be more than one percent sign to the left of the @ sign, in which case the route for the message to take (from right to left) is specified.

Any of the above can be used in the following variations. We recommended you always enclose the address portion in angle brackets (<>).

"text name" userid@host.	This is the form used by the address book to specify both the full text name of the user and the address. In this case the <angle brackets> are required.
userid@host (text name).	Many other mail systems use this form in From headers. The portion outside the parenthesis must be a valid address. If a comma is used inside the parentheses, it must be quoted.


Set Message Flags dialog box
“Set Message Flags” dialog box

If you are not already in the “Set Message Flags” dialog box, select a message in one of the current user’s mailboxes, and then select Flags from the File menu. The “Set Message Flags” dialog box appears. This is where you can modify the flags on a message for the current user. The message can be marked as Deleted, Read or Answered/Forwarded.


Notes about "Delete Host Mail"

The “Delete Host Mail” setting in the Logon dialog box determines how incoming mail is handled and viewed. In IMail Client, select POP Logon from the File menu. The Delete Host Mail setting is in the lower right of the dialog box.

When “Delete Host Mail” is turned off:

•	IMail Client maintains a connection with the server and can check for new mail at any time.

•	When you log on as the current user, the current user’s local mailboxes are ignored unless mail is transferred from the mail server to a client mailbox; however, you can still save mail in the current user’s local mailbox if you want to.

•	Each time you log on to the mail host, all messages appear to be new when they are first displayed.

•	When you are logged on as the current user, you will NOT be notified of new mail that arrives directly (without going through the server) on your system, including mail that you send to yourself.

Note: Normally, this setting is used when a user plans to access mail on the server from more than one system.

When “Delete Host Mail” is turned on:

•	Mail is moved from server to the current user’s Main mailbox when you log on as the current user.

•	A connection is maintained with host while you are logged on as the current user.

•	Messages for the current user that have been read appear read (not bold) because IMail Client is storing this info with the current user’s client information.

•	When the current user checks for new mail, the new mail appears new (bold).

•	If you are logged on as a particular user and you check for new mail, you are also notified of any mail that arrives directly to the client system.


URL Execution Support

This program supports the execution of URL (uniform resource locator) entries. Hold the CTRL key down and double-click a URL to execute it. In addition, you can just double-click the right mouse button on a URL to execute it. Supported URLs include HTTP, FTP, GOPHER, MAILTO and NEWS.


MIME (definition)

MIME (Multipurpose Internet Mail Extensions) is a standard that facilitates:

•	The inclusion of multiple objects in a single message

•	The representation of message body text in character sets other than US-ASCII

•	Multi-font messages

•	The inclusion of non-textual material such as images and audio fragments in e-mail

•	Future extensions of mail protocols to allow new types of Internet mail

MIME is defined in Request For Comments (RFC) 1521. Version 1 of MIME does NOT extend Internet mail header fields to permit anything other than US-ASCII text data.


Alias

An alias can be an alternate name for a user id; it can be used in place of the registered user ID when sending mail.


Current User

The “current user” is the user currently logged on to IMail Client. Since IMail Client is intended to be used by System Administrators of IMail Server, the current user can be the “root” account or any other account the System Administrator wants to use to test IMail Server.

Warning: The IMail Client application should NOT be used on the IMail Server system to view actual end-user mailboxes, as this may cause problems with remote access to the same mailboxes, depending on the remote clients being used.


UUENCODE

Uuencode translates a binary file into ASCII text, so the file can be sent through e-mail.


Overview of Mail Delivery Rules

You can use delivery rules (also known as “inbound processing rules”) to filter incoming mail based on the contents of To, From, Sender, Subject, the entire message Header (everything but the body of the message), or the Body of the message. Delivery rules can be applied to all mail for a mail host, to mail for individual users, or to a list-server mailing list. For example, you can search a header or body for “$$$ GET RICH QUICK” and if found, route the mail to a particular user account mailbox.

Note: The interface for, and explanation of, delivery rules is much more comprehensive in the Imail Administrator application. We strongly suggest that you do not use the rules interface in Imail Client, but instead use the more complete interface (and Help system) in Imail Administrator.


How Rules are Stored and Processed
How Delivery Rules are Stored and Processed

Delivery rules are stored in text files named rules.ima. If a delivery rule apply to a mail host, the rules.ima file is stored in the mail host directory. If the rule applies to an individual user, the file is stored in the user’s home directory. If the rule applies to a list-server mailing list, the rules.ima file is stored in the Lists directory.

IMail Server reads the rules.ima file(s) during the delivery process. The rules.ima file for the virtual host is evaluated first, and then the rules.ima file for the user or list.

Any rules.ima file can be copied to other directories; for example, if you create delivery rules for one user, you can copy the rules.ima file to the directories of other users to apply the same rules to them.


Rule Syntax

When you create a rule, the rule is entered in the rules.ima file in the following format:

message_area    condition    search_text    quantifier :    mailbox_name

(Click an element above to view a table showing the representation or expression and its meaning.


Message Area

Message Area	Representation
From:	F
Subject:	S
Sender:	N
To:	T
entire header (everything preceding the body)	H
entire body of message	B


Conditions

Condition	Expression
contains	~
does not contain	!~
equals	=
does not equal	!=


Quantifiers

Quantifier	Expression
Zero or more	*
One or more	+
Exactly 100	{100}
At least n1, but not more than n2 (where n1 and n2 are numbers)	{n1,n2}


Text Patterns

Text Pattern	Expression
Any character	.
Any of the values separated by vertical bars within the parentheses; the vertical bar represents “or”	(this|that|other)
Any word character (a-z, A-Z, 0-9)	\w
Any non-word character	\W
Any digit (0-9)	\d
Any non-digit	\D
Any white space (spaces and/or tabs and/or carriage returns)	\s
Any non-white space	\S
Any punctuation character	\p
Any non-punctuation character	\P

Note that a few characters that have special meaning.


Characters with Special Meaning

The following characters have special meaning in a rule:

{}()|*+,.:

If you want to use one of these characters in a search string, precede it with a backslash. For example, to search for a plus sign, enter \+ in the search string.